home *** CD-ROM | disk | FTP | other *** search
/ SGI Developer Toolbox 6.1 / SGI Developer Toolbox 6.1 - Disc 4.iso / src / swtools / libdwarf / dwarf.man < prev    next >
Encoding:
Text File  |  1994-08-02  |  3.1 KB  |  70 lines
  1.  
  2.      DWARF(4)          UNIX System V (May 15, 1994)           DWARF(4)
  3.  
  4.      NAME
  5.           dwarf - dwarf version 2 debugging information format
  6.  
  7.      SYNOPSIS
  8.           #include <dwarf.h>
  9.  
  10.      DESCRIPTION
  11.           DWARF is a format for the information generated by
  12.           compilers, assemblers, and linkage editors that is necessary
  13.           for source-level debugging.  It allows a compact
  14.           representation of programs in many languages and is easily
  15.           extended to handle additional languages and individual
  16.           compiler/debugger requirements.  Consumers reading DWARF
  17.           information they do not understand are able to easily skip
  18.           past that information, meaning that older consumers are not
  19.           broken by the addition of new features.
  20.  
  21.           DWARF itself does not specify how to generate or use the
  22.           information.  Instead, it defines the 'bits on the disc'.
  23.           See the libdwarf(4) man page for information on reading and
  24.           writing DWARF information.
  25.  
  26.           This format was designed by a multi-company committee called
  27.           the PLSIG working under the auspices of Unix International.
  28.           The format is based on the SVR4 debugging information
  29.           format, (which might be called version 0) and a codification
  30.           of that format developed by the committee (which was called
  31.           version 1).  Version 2 was designed by the committee to
  32.           reduce the disk space used and to add descriptive power (as
  33.           compared to versions 0 and 1).  The Version 2.0.0 Industry
  34.           Review Draft was made available July, 1993.  The document
  35.           provided below is that Draft.
  36.  
  37.           For details of the format see the document DWARF Debugging
  38.           Information Format, which is the file dwarf.v2.mm in the
  39.           IDO/dev option subsystem compiler_dev.opt.dwarf.  The file
  40.           index.v2.mm is an index to that document.  The .ps files are
  41.           PostScript versions of the same files.
  42.  
  43.           The DWARF debugging information is present only with the
  44.           MIPSpro compilers.  This information is put, as needed, into
  45.           sections of an ELF object file named .debug_info,
  46.           .debug_frame, .debug_line, .debug_aranges, .debug_loc,
  47.           .debug_frame, .debug_str, .debug_abbrev, .debug_pubnames,
  48.           .debug_weaknames, .debug_funcnames, .debug_typenames, and
  49.           .debug_varnames.
  50.  
  51.           Earlier compilers put debugging information into the .mdebug
  52.           section of the ELF file (the section format is identical to
  53.           the IRIX 4 COFF symbol table, so the .mdebug section is
  54.           sometimes referred to as 'the symbol table').
  55.  
  56.      Page 1                                          (printed 7/13/94)
  57.  
  58.      DWARF(4)          UNIX System V (May 15, 1994)           DWARF(4)
  59.  
  60.      FILES
  61.           /usr/people/4Dgifts/examples/dwarf/dwarf.v2.mm
  62.           /usr/people/4Dgifts/examples/dwarf/dwarf.v2.ps
  63.           /usr/people/4Dgifts/examples/dwarf/index.v2.mm
  64.           /usr/people/4Dgifts/examples/dwarf/index.v2.ps
  65.  
  66.      SEE ALSO
  67.           libdwarf(4) dwarfdump(1)
  68.  
  69.      Page 2                                          (printed 7/13/94)
  70.